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SECTION 1 , 0 SUMMARY 

The Display AButments (DAB) program is a graphics system for 
displaying PAN AIR geometries. It can be used to label 
geometry components, such as abutments, networks, and network 
edges. In addition. DAB can oreate a file identifying 
possible errors in a PAN AIR abutment list. A separate system 
( MAKADF ) has been developed to format abutment list 
information returned from PAN AIR into the Abutment Definition 
File format required for input to DAE. DAB oan help to 
alleviate the very time-oonsuming and error prone "abutment 
list checking" phase of developing a valid PAN AIR geometry. 

It oan also be used to examine details of the geometry 
definition before PAN AIR is used. DAB therefore represents a 
valuable tool for debugging complex PAN AIR geometry 
definitions . 

DAB is written in FORTRAN 77 and runs on a Digital Equipment 
Corporation ‘VAX-11/780 under VMS. It utilizes a speoial 
"color" version of the SKETCH hidden line analysis routine 
developed by David Hedgley (NASA Ames-Dryden) and the ASP 
graphics package, which creates a standard Devioe Independent 
Plot (DIP) file. DAB was developed for the PAN AIR user 
community within the Advanced Aerodynamics Concepts Branch of 
NASA Ames Research Center by staff from the Palo Alto office 
of Informatics General Corporation under Contraot 
♦NAS2-1 1555-306- 1 . 


SECTION 2 . 0 INTRODUCTION 

DAB is a graphics system for plotting PAN AIR geometries. 
Display options include labeling networks, network edges, and 
PAN AIR abutments with appropriate identifiers. DAB can also 
display individual panels of each network in dashed line type. 
Network edges are drawn as solid lines; abutments are drawn as 
doubly-thick solid lines. For cases 'where there is no 
Abutment Definition File (ADF) specif ed in the user's Control 
File, DAB can reflect the PAN AIR half-configuration geometry 
about the XZ plane (to display the full configuration) and/or 
automatically eliminate wake networks from the display. 
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DAB allows user-specification of plot titles, geometry 
features to be labeled, viewing angle, and plot limits for 
zooming into regions of the geometry which are of particular 
interest. Labels oreated for the various geometry components 
are of the following form: 

LABEL DESCRIPTION 


N * * * Network * * * 

E ' Edge * 

A *•* Abutment * * * 

ESA* * * * Empty-spaoe abutment **** 

PSA* * * * Plane of symmetry abutment * * * * 


Labels for abutments and network edges are rotated so that 
they are printed parallel to the line segment being labeled. 

In cases where the PAN AIR half-configuration geometry is 
reflected, network numbers for reflected networks are offset 
by the number of networks processed in the original 
half-model. 

The user can optimise the efficiency of runs by grouping 
requests for the same view angle in the DAB Control File. DAB 
recognizes consecutive identical view angle requests and does 
not go through the time-consuming hidden line analysis unless 
a different angle (roll, pitch, yaw) has been specified in tue 
Control File. 

There are several error conditions which are possible within 
the DAB program. Most of these involve input PAN AIR geometry 
files which contain too much data for the. program to handle. 
When such a situation is recognized, the user is so advised 
and the program terminates. 


SECTION 3 EN/IRONMENT (NASA Ames Research Center) 

The DAB program is written in FORTRAN and runs on a Digital 
Equipment Corporation VAX 11/780 under VMS. It is currently 
available on the FAE VAX node at NASA Ames Research Center and 
can be invoked FAE :: FACO :[ PANAIR ..DAB 3 DAB , It may be necessary 
to increase the VAX VMS system parameter PGFLQUOTA for the 
account from which DAB is to be run (because of the large 
arrays needed by this program), A PGFLQUOTA of 80000 has 
proven to be satisfactory for current users, who are dealing 
with PAN AIR geometries having up to 30000 panels and 200 
networks (for full configurations), 
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DAB is used in oonjunotion with the PAN AIR and MAKADF 
programs. MAKADF is a FORTRAN program vhioh runs on the VAZ 
and which oreates an ADF from abutment list information 
provided in PAN AIR output files. MAKADF prompts for the name 
of the PAN AIR output file containing the abutment list. 

A standard soenario for using DAB follows : 

o A PAN AIR geometry file is oreated. 
o If abutments are to be investigated; 

the geometry is submitted to PAN AIR so that an 
abutment list is generated, MAKADF is run to 
format the abutment list into the ADF format, 
o A DAB Concrol File (shown in Appendix A) is oreated 
to specify the plots which are desired, 
o DAB is run to oreate a Device Independent Plot (DIP) 
file. 

o Plots are created using one of the many DIP file 
processors available at Ames (e.g. DIPQMS, DIPTEK, 

DIPVER . DIPVRC ) . 


Because of the GPU time requirements for the hidden line 
analysis, it is often appropriate to run DAB in BATCH mode. 

CPU times to generate plot frames vary, of course, with the 
complexity (i.e, number of networks, panels, abutments) of 
the PAN AIR model. For reference, the F16 geometry shown in 
Appendix C contains nearly 11000 panels: there was no Abutment 
Definition File available for this geometry. Creating the DIP 
file for the two F16 plots shown required approximately 25 
minutes of CPU time on the VAZ. If no ADF is specified in the 
Control File and reflection (symmetry) is requested, the 
number of networks and panels double. Processing time on the 
VAZ increases similarly. 

Tailoring dimensions in the DAB program to handle specific 
(large) geometry combinations is readily accomplished by 
modifying quantities declared in PARAMETER statements in the 
DAB driver (and recompiling and relinking). Dimensions' 
required to handle large PAN AIR geometries may require 
certain VAZ VMS system parameters, (e.g. PGFLQUOTA and 
Virtual Page Count) to be increased to allow linking and 
running of programs with large memory requirements. 
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SECTION 4 INPUT REQUIREMENTS 

DAB requires two input files - a DAB Control File and a PAN 
AIR geometry file. An Abutment Definition File may also be 
supplied. 

The DAB Control File oontains the name of the PAN AIR geometry 
file to be prooessed. the name of the Abutment Definition File 
Clf desired), quantities whioh oontrol display of wake 
networks and geometry refleotion to oreate and display a full 
configuration . and the view angles and plot options to be used 
to generate desired plots. The structure of the DAB Control 
File is straightforward and is shown in Appendix A. 

The PAN AIR geometry file oontains the PAN AIR networks whioh 
are to be displayed? The structure of this file is not 
presented here, but is discussed in PAN AIR documentation. If 
wake networks are to be ommitted from plots, then EACH wake 
network in the PAN AIR geometry file must be followed by a 
"BOUNDARY CONDITION* " record, For DAB, a valid wake network 
must be a olass 1. subclass 4 Cor 5) network 
(e.g. BOUNDARY CONDITION- 1 4). 

The optional Abutment Definition File (ADF) lists the PAN, 
AIR-defined abutments in terms of network numbers and starting 
and ending indioes along the edges of networks. The structure 
of' the ADF is shown in Appendix B. An ADF oan be created 
(with substantial effort) using an editor, or. more simply, by 
running the MAKADF program, which reads in the abutment list 
created by the PAN AIR DQG module and reformats the 
information into the specified ADF format. 


SECTION 5 OUTPUTS 

DAB creates a standard Device Independent Plot (DIP) file. 
Plots of DIP files oan be created using any of several DIP 
file processing utilities available at Ames, such as DIPQMS, 
DIPVER , DIPD46 . DIPVRC, and DIPTEK. The plots shown in 
Appendix C were created on a QMS laser printer using DIPQMS. 

If an Abutment Definition File is specified in the Control 
File. DAB creates an Abutment Error Checking File which 
contains statistics (starring points, end points, and 
midpoints) for all abutments and whioh identifies POSSIBLE 
problem areas in the abutment definitions, such as two 
definitions of a single abutment which proceed in opposite 
directions. It is emphasized that the abutment errors 
reported in this file may be unjustified in certain cases, due 
to the considerable flexibility provided by PAN AIR for 
defining networks. The name of the Abutment Error Checking 
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File is derived from the name of the input Abutment Definition 
File with a filename extension of ".ERR". 


SECTION 6 DISCUSSION OF METHOD 

DAB uses the SKETCH hidden line analysis algorithm developed 
by David Hedgley (reference I) to determine which elements of 
the PAN AIR model are visible in the user-speoif ied view. The 
version of SKETCH being used includes a color feature whioh is 
not available in general releases. DAB relies heavily upon 
the oolor capability to identify the type of picture element 
(e.g. network center or abutment segment) being returned 
after the hidden line/surface analysis has been performed. 

The basic criteria used to determine if a plot element should 
be labeled (if requested in the Control File) are: 

1) The center of the network containing the feature is 
"visible" 

2) Enough room exists to label the feature. 

DAB passes a short line segment at the center of each network 
(and normal to the panel containing the network center) to the 
hidden line analysis routine. If any part of that segment is 
determined to be visible, the network center is considered 
visible and labels for network center, edges, and abutments 
are enabled if requested. The algorithm implemented is not 
100% foolproof, PAN AIR geometry panels may violate the 
planar polygon requirement of the SKETCH hidden line surface 
analysis software. Because of this, DAB will occasionally 
fail to label elements of a picture for a visible network 
which should be labeled, In addition, the short segment at 
the oenter of a hidden network may "pierce" the network which 
exists on the far side of the geometry so that labels appear 
for a network which is not really visible. 


1) David Hedgley's SKETCH is a solution to the classic hidden 
line problem in computer graphics. Relevant literature includes 

A General Solution to the Hidden-Line Problem 
NASA Reference Publication 1085 

User ' s Guide for SKETCH 

NASA Technical Memorandum 81369 
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Coincident geometries are also a problem, DAP passes network 
edge segments to the hidden line analysis software many times. 
The result is that a given segment may be determined to be 
visible as a panel edge, but not as a network edge or as a 
segment of an abutment. There are therefore occasionally 
"random holes" in some line types on plots. 
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APPENDIX A DAB CONTROL FILE 


Initial reoords in the Control File contain the names of the 
PAN AIR geometry file and of the Abutment Definition File to 
be used for the current run. As noted, the ADF is optional. 
If an ADF is not available or is not to be used, the 
corresponding reoord in the Control File should be blank. If 
no ADF is specified, the next two reoords can be used to 
suppress wake networks from plots and or to reflect the 
geometry so that a full configuration is displayed. In the 
example below, an ADF is speolfled so that the "NOWAKES" and 
"SYMMETRY" records whloh follow are ignored, They must still 
appear in the Control File. 

For each desired plot, the Control File allows the user to 
specify plot titles, plot options to be activated, the view 
angle to whioh the PAN AIR geometry is to be rotated, and the 
X and Y display limits to be used so that regions of interest 
can be closely scrutinized. 


A sample Control File follows. Descriptions of records are 
enclosed in angle braokets (• ■) for clarification, and are 
not part of the file. All reoords must begin in column 1. 


GEOM . DAT 

ABUT . DAT 

NOWAKES 

SYMMETRY 

Plot number 1 

networks and edg°« 

en 

155. 40. 220. 

-10. 500. 6300. 6800. 
Plot number 2 


<Name of FAN AIR input f ile * 

•Name of Abutment Definition File> 

'Causes wake networks to be ommitted^ 
'Causes geometry to be reflected. 

-Title 1; up to 80 characters- 
'Title 2: up to 80 characters 

<Plot options E and N selected. .. see below 
< Roll , pitch, yaw.,. see below > 

<Xmin, xmax, ymin. ymax. , see below » 

'Title 1 .for second plot, eto. > 


The following briefly describes the control quantities which 
must be provided in the Control File. 

NOWAKES 

This option is only valid when the ADF reoord in the Control 
File is blank, When an "N" or "n" appears in oolumn 1 of this 
record. DAB ignores wake networks in the PAN AIR geometry 
file. (Valid wake networks for DAB have class 1. subclass 4 
(or 5) boundary conditions.) When this option is used, EACH 
wake network in the PAN AIR geometry must be followed by a 
"BOUNDARY CONDITION® " record, which must appear before the 
start of the next network- definition. 
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SYMMETRY 


This option, also, is only valid when the ADF reoord ip the 
Control File is blank. When an "S" or "s” appears in column 1 
of this reoord, DAB refleots all networks in the PAN AIR 
geometry file about the XZ plane. This allows display of both 
halves of the model geometry. Ifc DOUBLES the number of 
networks and panels to be prooessed. The NOWAKES option may 
be used in oonjunotion with the SYMMETRY option. 

PLOT OPTIONS 


Seleot any combination (in any order) of P. A. N, E, G (lower 
oase equivalents also allowed) to request desired plot and 
labeling funotiono as follows: 


OPTION 
P (or p; 
A (or a) 
N (or n) 
E (or e) 
G (or g) 


DESCRIPTION 

Draw panel boundaries in dashed line type. 

Label abutments. 

Label networks, 
v'-bel network edges. 

Draw soaled axes (grid) around plot area. This 
option is very useful for identifying appropriate 
axis limits to be used when zooming in on a 
particular area of the geometry is desired. 


This reoord must begin in column 1 and must not oontaln 
embedded blanks. If the plot options reoord is blank, the 
corresponding plot will sh'ow unlabeled network edges only. 

ROLL. PITCH, and YAW 


The viewing angle must be specified in degrees. The order in 
whioh the body-axls-oentered rotations are performed is: 1) 

roll 2) pitch 3) yaw. 

XMIN. XMAX. YMIN , and YMAX 


These values represent axes limits for the plot area, and are 
not necessarily related to coordinates in the reference axis 
system. A standard plot format is used, with X increasing to 
the right and Y increasing up the page. 

By requesting a plot with XMIN, XMAX, YMIN. and YMAX values' 
whioh define the rectangular region of interest . a user oan 
zoom in on a speoific region on the model surfaoe. This 
magnification feature is also extremely useful to eliminate 
crowded (sometimes illegible) labels. DAB may adjust these 
plot limits to maintain geometry proportions on plots. If the 
user wishes to see the entire PAN AIR model definition, a 
self-scaled view may be created by specifying 0.0 for all four 
plot axes limits. For a given view angle, it is usually 
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necessary to request suoh a self-soaled plot to identify 
exaotly where the rotated coordinates of the model lie so that 
subsequent plot requests oan zoom into portions of the model 
whioh are of particular interest. (Note.* Rotated coordinates 
of a given geometry may differ for the WAKES and NOWAKES oases 
due to the use of different oenters of rotations for these two 
situations . ) 

Axes limits are displayed at the top of each plot for 
reference. In addition, by using the M G" plot option, 
graduations on each axis are labeled to help the user 
determine coordinates which define the region of interest. 
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APPENDIX B ABUTMENT DEFINITION FILE 


Abutment Definition Files CADFs) contain PAN AIR-defined 
abutment information, suoh as network au«.oer and indioes for 
the starting and ending points of the abutment for the ourrent 
network, Network names are inoluded for referenoe only. ADFs 
are most readily oreated by running the MAKADF program" on the 
FAE VAX (FAE; :FAC0: [PANAIR. DAB] MAKADF). MAKADF reformats PAN 
AIR abutment list output into the ADF struoture shown below. 

The following is exoerpted from a valid ADF. Descriptions are 
provided in angle braokets (< » and are not part of the file. 


109 

1 

2 

<* Of 
<Abut 

abutments > 

# , * of networks 

in the abut. For each ; 

19 

4 

21 1 

WING-UPR ‘network * . edge # . begin, end 

17 

3 

17 3 

EJC-UPR <next 

network *, etc, > 

2 

2 


< Next 

abutment #, etc, > 

20 

4 

(31 1 

WING-LWR 


18 
» • * 

1 

17 1 

EJC-LWR 


• ♦ i 
2010 


2 

< Plane 

of symmetry abutment > 

1 

1 

1 4 

NOSE-1 

-1 

ill 

0 

0 0 

PLN OF SYMMETRY 

• 

• i * 
1001 


1 

' Empty 

spaoe abutment 

39 

3 

5 1 

NOZ-WAKE-UPR-39 
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APPENDIX C SAMPLE PLOTS 


P a £ es contain plots oreated bv the 
DIPQMS was used to plot the resulting DIP files 


DAB program, 
on a QMS laser 















Grumman 623 (WITH PLUMES!), f *' •'O'C'; where there is no ADF, suppressing 
wakes and reflecting networks to form o full configuration are possible. 

ABUTMENTS NETWORKS PANELS ROLL PlIfH .AW /MIN VMAX rMIN YMAX DATE 

.5000 JOOO i?000 -17.26 6865 -2S: 6283 13-JUH -85 




Array dimensions in DAB can be n*liu c 'i'-l modify lo handle specific npeds 
of large PAN AIR geometries. This MC hall model contains early 11000 panels. 
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By specifying appropriate v Mill. r M!M. and YMAX values, DAB can be inode 

lo "zoom" into regions ol ge'-melrv which are of particular interest. 
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Use of the Display AButments (DAB) program which plots PAN AIR geonetries is 
presented. The DAB program creates hidden line displays of PAN AIR geometries 
and labels specified geometry conponents, such as abutments, networks, and 
network edges. It can be used to alleviate the very time-consuming and error 
prone "abutment list checking" phase of developing a valid PAN AIR geonetry, 
and therefore represents a valuable tool for debugging conplex PAN AIR 
geometry definitions. , 

DAB is written in FORTRAN 77 and runs on a Digital Equipment Corporation 
VAX-11/780 under VMS. It utilizes a special color version of the SKETCH 
hidden line analysis routine developed by David Hedgley and the ASP graphics 
package, which creates a standard Device Independent Plot (DIP) file. DAB was 
developed for the PAN A.IR user cortmunity within the Advanced Aerodynamic 
Concepts Branch of NASA Ames Research Center by staff from the Palo Alto 
office of Informatics General Corporation. 
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